Rib Generator Plug-In Developer's Kit - Version 1.0
----------------------------------------------
Requirements
------------
To compile Rib Generator Plug-Ins, you must have Think C version 5.0 or later. Other development environments are not directly supported, but it shouldn't take much work to adapt the supplied source files to work in another environment.
To execute any plug-ins you build, you must have a copy of Showplace 2.0 or later installed on your system.
Installation
-----------
To install the developer's kit...
1) Double-click on the file RibGenPlugInDevKit.sea and expand the contents of the archive to your hard disk (it doesn't matter where). This file can be found on Disk 1 of the Showplace 2.0 release. Expanding the file will result in a folder called 'RibGenPlugInDevKit'
2) Move the 'PixarLibraries' folder from the RibGenPlugInDevKit folder to the folder that contains your Think C compiler.
3) To build Rib Generator Plug-Ins, you must have copies of a few system header files that were not supplied with Think C 5.0 but are supplied with Think C 6.0. Copies of these headers are supplied in the 'Think5ExtraIncludes' folder. If you are using Think C 5.0, copy this folder from the RibGenPlugInDevKit folder to the folder that contains your Think C compiler.
5) Building plug-ins requires one header file that is found in the Think Class Library sources, the file 'global.h'. If you have not installed the Think Class Library as part of your Think C development environment, locate this file on your Think C release disks and put it in the folder that contains your Think C compiler.
6) The remaining files in the 'RibGenPlugInDevKit' folder are a simple plug-in example that you can now build using Think C, and documentation explaining how to develop plug-ins.
Building The Example
-------------------
The example Rib Generator Plug-In is a simple plug-in that generates Paraboloids. The example consists of two Think C projects, ParaboloidTestπ and Paraboloidπ. ParaboloidTestπ produces a normal Mac application. This version of the plug-in is used to debug the plug-in's interface and to study its behavior. Paraboloidπ produces the actual plug-in that can be accessed by Showplace.
To build ParaboloidTestπ, double-click on the project and choose the 'Bring Up To Date' menu item from Think C's 'Project' menu. To run the plug-in under the Think C debugger, select the 'Run' menu item from the 'Project' menu.
To build ParaboloidTestπ, double-click on the project and choose the 'Bring Up To Date' menu item from Think C's 'Project' menu. To build the actual plug-in, select the 'Build Code Resource' menu item from the 'Project' menu. When a dialog appears, press the Save button.
